[BillingTrust] Add Microsoft.BillingTrust TypeSpec API spec (2026-03-17-preview) by abhimrnandan-ms · Pull Request #43896 · Azure/azure-rest-api-specs

abhimrnandan-ms · 2026-06-10T20:36:17Z

Summary

New ARM resource provider: Microsoft.BillingTrust

API version: 2026-03-17-preview (preview)
Resources: Assessments (CRUD + list), Rules (CRUD + list)
TypeSpec source with generated OpenAPI
Provides Assessment and Rule resources used to evaluate trust attributes (such as education-domain qualification and business verification) of a billing account

Previously merged in azure-rest-api-specs-pr PR #28678.

Release Plan

Release Plan: #34897
Service Tree ID: 403a7ada-b47f-4ac7-ad33-cd76e1fa7614

Packages

Azure.ResourceManager.BillingTrust (.NET)
azure-mgmt-billingtrust (Python)
azure-resourcemanager-billingtrust (Java)
@azure/arm-billingtrust (JavaScript)
armbillingtrust (Go)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

github-actions · 2026-06-10T20:37:12Z

Next Steps to Merge

✅ All automated merging requirements have been met! To get your PR merged, see aka.ms/azsdk/specreview/merge.

Comment generated by summarize-checks workflow run.

github-actions · 2026-06-10T20:46:54Z

API Change Check

APIView identified API level changes in this PR and created the following API reviews

Language	API Review for Package
Swagger	Microsoft.BillingTrust-BillingTrust
TypeSpec	Microsoft.BillingTrust
Go	sdk/resourcemanager/billingtrust/armbillingtrust
Python	azure-mgmt-billingtrust
JavaScript	@azure/arm-billing-trust
Java	com.azure.resourcemanager:azure-resourcemanager-billing-trust

Comment generated by After APIView workflow run.

abhimrnandan-ms · 2026-06-10T21:05:20Z

The Microsoft.BillingTrust namespace was merged to RPSaaSMaster in azure-rest-api-specs-pr via PR 28678 (ARM review signed off). However, the CI-RpaaSRPNotInPrivateRepo check does not appear to detect it.

Private repo PR link : https://github.com/Azure/azure-rest-api-specs-pr/pull/28678
Could someone from the ARM review team help investigate and unblock this PR?

abhimrnandan-ms · 2026-06-10T21:07:17Z

/azp run

azure-pipelines · 2026-06-10T21:07:24Z

You have several pipelines (over 10) configured to build pull requests in this repository. Specify which pipelines you would like to run by using /azp run [pipelines] command. You can specify multiple pipelines using a comma separated list.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

…ithub.com/Azure/azure-rest-api-specs into users/abmohanr/billingtrustrp-public-spec

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

abhimrnandan-ms · 2026-06-16T22:52:58Z

@microsoft-github-policy-service agree [company="Microsoft"]

abhimrnandan-ms · 2026-06-17T17:33:14Z

@microsoft-github-policy-service agree

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

abhimrnandan-ms · 2026-06-17T21:07:32Z

@gary-x-li
This issue was raised and resolved during the ARM review of the private repo PR (azure-rest-api-specs-pr#28678), which was merged with ARMSignedOff. Here is the context:

1. BillingRP owns GDPR handling. BillingTrust is a read-only projection of the billing account's sold-to data — not the system of record. GDPR cleanup (right-to-erasure, etc.) is handled by BillingRP, and BillingTrust reflects/propagates changes and cleanup automatically.

2. PII tagging is already in place. The SoldTo model @doc carries an explicit PII classification block, and every PII-bearing field has a per-field "PII — postal address" or "PII — contact" marker in its documentation.

3. ARG indexing is disabled on the rules resource type. We set resourceGraphConfiguration.enabled: false on assessments/rules so the PII fields never reach the ARG cache. The parent assessments RT (which does not carry PII) keeps ARG indexing enabled.

4. expandCustomerData query parameter is not feasible for this resource type. Reads are served by MetaRP from its tracked-resources cache — the RP is not invoked on the read path. Implementing an expand pattern would require registering ResourceRead extensions and changing the read architecture. Given that ARG indexing is disabled on the rules RT, disabling ARG is the proportionate fix per the architect's guidance.

The soldTo, registrationNumber, and taxIds fields are all @visibility(Lifecycle.Read) (read-only, server-managed) — they are populated from the billing account at rule creation time and cannot be supplied or modified by end users.

abhimrnandan-ms · 2026-06-19T18:05:04Z

@gary-x-li — Friendly follow-up. The ARG002 finding on SoldTo was already reviewed and accepted during the private repo ARM review (PR #28678, merged with ARMSignedOff). The mitigation is disabling ARG indexing on the rules resource type (resourceGraphConfiguration.enabled: false). Full justification is in my earlier comment above.

Could you please review and sign off? We're targeting a Public Preview release this month. Thank you!

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

msyyc · 2026-06-30T02:25:11Z

python fails for a known issue and I have sought help in teams channel

msyyc · 2026-07-01T02:46:44Z

python check pass

Add Microsoft.BillingTrust TypeSpec API spec (2026-03-17-preview)

2184a28

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

github-actions Bot added ARMModelingAutoSignedOff ARMReview CI-RpaaSRPNotInPrivateRepo new-api-version new-rp-namespace NotReadyForARMReview resource-manager RPaaS SuppressionReviewRequired TypeSpec Authored with TypeSpec labels Jun 10, 2026

abhi3047office and others added 4 commits June 10, 2026 15:16

Add .NET emitter configuration for Microsoft.BillingTrust

0fcf037

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Merge branch 'main' into users/abmohanr/billingtrustrp-public-spec

a0b648a

add client.tsp

9ca3c92

Merge branch 'users/abmohanr/billingtrustrp-public-spec' of https://g…

33b73f6

…ithub.com/Azure/azure-rest-api-specs into users/abmohanr/billingtrustrp-public-spec

github-actions Bot added WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required and removed NotReadyForARMReview CI-RpaaSRPNotInPrivateRepo labels Jun 16, 2026

abhi3047office and others added 2 commits June 16, 2026 15:32

Add tsp-output metadata for SDK generation

27f3de8

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Fix SpellCheck: add username to cspell dictionary

a27d1d4

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

abhimrnandan-ms added the PublishToCustomers Acknowledgement the changes will be published to Azure customers. label Jun 16, 2026

abhimrnandan-ms force-pushed the users/abmohanr/billingtrustrp-public-spec branch from a27d1d4 to 7039a86 Compare June 17, 2026 17:32

abhimrnandan-ms enabled auto-merge (squash) June 17, 2026 17:34

abhi3047office and others added 3 commits June 17, 2026 13:07

add client.tsp

4aec6d6

Add tsp-output metadata for SDK generation

f55699f

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Fix SpellCheck: add username to cspell dictionary

238f3b5

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

abhimrnandan-ms force-pushed the users/abmohanr/billingtrustrp-public-spec branch from 7039a86 to 238f3b5 Compare June 17, 2026 20:07

abhimrnandan-ms removed the ARMChangesRequested label Jun 18, 2026

github-actions Bot added the WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required label Jun 18, 2026

gary-x-li added ARMSignedOff <valid label in PR review process>add this label when ARM approve updates after review Approved-Suppression and removed WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required labels Jun 19, 2026

devapathni and others added 8 commits June 22, 2026 10:03

Merge branch 'main' into users/abmohanr/billingtrustrp-public-spec

8f8bf34

change sdk namespace to bililng.trust

95222ed

Merge branch 'main' into users/abmohanr/billingtrustrp-public-spec

cf0a49f

Update SDK package names to Azure.ResourceManager.Billing.Trust

f6bcf5a

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Fix TypeSpec validation: add client.tsp import to main.tsp

1db39f9

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Fix Go service-dir: single segment required by SDK validation

fbc72f7

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Fix Java service-name: dots invalid in Java class names

016eaa4

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Update tspconfig.yaml

9d5fd25

Merge branch 'main' into users/abmohanr/billingtrustrp-public-spec

475dcca

abhimrnandan-ms and others added 2 commits June 30, 2026 21:15

Merge branch 'main' into users/abmohanr/billingtrustrp-public-spec

9c5661c

Merge branch 'main' into users/abmohanr/billingtrustrp-public-spec

fa8d181

wanlei123188-gm approved these changes Jul 1, 2026

View reviewed changes

abhimrnandan-ms merged commit 25b0524 into main Jul 1, 2026
41 of 42 checks passed

abhimrnandan-ms deleted the users/abmohanr/billingtrustrp-public-spec branch July 1, 2026 16:36

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[BillingTrust] Add Microsoft.BillingTrust TypeSpec API spec (2026-03-17-preview)#43896

[BillingTrust] Add Microsoft.BillingTrust TypeSpec API spec (2026-03-17-preview)#43896
abhimrnandan-ms merged 23 commits into
mainfrom
users/abmohanr/billingtrustrp-public-spec

abhimrnandan-ms commented Jun 10, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jun 10, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jun 10, 2026 •

edited

Loading

Uh oh!

abhimrnandan-ms commented Jun 10, 2026 •

edited

Loading

Uh oh!

abhimrnandan-ms commented Jun 10, 2026

Uh oh!

azure-pipelines Bot commented Jun 10, 2026

Uh oh!

abhimrnandan-ms commented Jun 16, 2026

Uh oh!

abhimrnandan-ms commented Jun 17, 2026

Uh oh!

abhimrnandan-ms commented Jun 17, 2026 •

edited

Loading

Uh oh!

abhimrnandan-ms commented Jun 19, 2026 •

edited

Loading

Uh oh!

msyyc commented Jun 30, 2026

Uh oh!

msyyc commented Jul 1, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Uh oh!

Conversation

abhimrnandan-ms commented Jun 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Release Plan

Packages

Uh oh!

github-actions Bot commented Jun 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Next Steps to Merge

Uh oh!

github-actions Bot commented Jun 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

API Change Check

Uh oh!

abhimrnandan-ms commented Jun 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

abhimrnandan-ms commented Jun 10, 2026

Uh oh!

azure-pipelines Bot commented Jun 10, 2026

Uh oh!

abhimrnandan-ms commented Jun 16, 2026

Uh oh!

abhimrnandan-ms commented Jun 17, 2026

Uh oh!

abhimrnandan-ms commented Jun 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

abhimrnandan-ms commented Jun 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

msyyc commented Jun 30, 2026

Uh oh!

msyyc commented Jul 1, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

abhimrnandan-ms commented Jun 10, 2026 •

edited

Loading

github-actions Bot commented Jun 10, 2026 •

edited

Loading

github-actions Bot commented Jun 10, 2026 •

edited

Loading

abhimrnandan-ms commented Jun 10, 2026 •

edited

Loading

abhimrnandan-ms commented Jun 17, 2026 •

edited

Loading

abhimrnandan-ms commented Jun 19, 2026 •

edited

Loading